home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / applications / wp / ags261-p1.lha / README.AMIGA
Encoding:
Text File  |  1993-09-12  |  6.4 KB  |  172 lines
  1. Subject: Amiga Ghostscript for Intuition & RETINA
  2. Class: util/gnu
  3. Uploader: ah@rbg.informatik.th-darmstadt.de
  4.  
  5.  
  6. This file is part of Ghostscript.
  7.  
  8. Ghostscript is distributed in the hope that it will be useful, but
  9. WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
  10. to anyone for the consequences of using it or for whether it serves any
  11. particular purpose or works at all, unless he says so in writing.  Refer
  12. to the Ghostscript General Public License for full details.
  13.  
  14. Everyone is granted permission to copy, modify and redistribute
  15. Ghostscript, but only under the conditions described in the Ghostscript
  16. General Public License.  A copy of this license is supposed to have been
  17. given to you along with Ghostscript so you can know your rights and
  18. responsibilities.  It should be in a file named COPYING.  Among other
  19. things, the copyright notice and this notice must be preserved on all
  20. copies.
  21.  
  22. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  23.  
  24. ***********************************************************************
  25. * This file describes the additional device drivers of the amiga port *
  26. ***********************************************************************
  27.  
  28.  
  29. The 'intui' device
  30. ------------------
  31.  
  32. The intui device was written by Markus (Landi) Landgraf.
  33.  
  34. The intui device is similar to the X device on UNIX stations.  When
  35. ghostscript is invoked with this device chosen, it opens an Amiga
  36. Intuition window with system gadgets and two scroller Gadgets. The
  37. scroller gadgets are meant to scroll through an output that's bigger
  38. than the window ( this is normally the case, because the standard size
  39. of the intuition device is dinA4, wich is bigger than for example a
  40. 15''-Monitor). To use the intui device as default, set the environment
  41. variable 'GS_DEVICE' to 'intui'. The intui device should not disturb
  42. the workbench colors, so it was only possible to make a black and
  43. white display of the output with the darkest workbench color as black
  44. and the brightest as white.  When the output in the window seems
  45. bended, the default settings for device-resolution are no more valid,
  46. the user has to compute it from the size and pixels of her/his display
  47. and set it by the -r option of ghostscript (see use.doc).
  48.  
  49. -------------------------------------------------------------------
  50.  
  51. NAME
  52.  
  53.   ilbm-retina.doc
  54.  
  55. DATE
  56.  
  57.   Sep 17,1993
  58.  
  59. DESCRIPTION
  60.  
  61.   Documentation for ILBM and RETINA drivers
  62.  
  63. AUTHOR
  64.  
  65.   Andreas Heitmann
  66.   Kasseler Str. 67
  67.   34308 Emstal 1
  68.   Germany
  69.  
  70. EMAIL
  71.  
  72.   andreas@gotcha.swb.de
  73.   andreas@ws-01.iset-kassel.de
  74.   ah@hrz-serv7.hrz.uni-kassel.de
  75.   ah@rbg.informatik.th-darmstadt.de
  76.   heitmann@crunch.ikp.physik.th-darmstadt.de
  77.   (still collecting accounts...)
  78.  
  79. RETINA DOCUMENTATION
  80.  
  81.   The RETINA driver for Ghostscript is only useful for the Amiga
  82.   platform, because the RETINA-hardware does only exist for this
  83.   computer. The driver supports all display modes, but there are still
  84.   bugs in the retina.library which make the 16 bit mode useless.
  85.  
  86.   To display a Postscript picture on a RETINA screen you have to set
  87.   the output device using the Ghostscript command line switch
  88.  
  89.     -sDEVICE=retinaXX
  90.  
  91.   where XX has to be replaced by 8,16 or 24 corresponding to the
  92.   desired number of BitPlanes. The resolution of the RETINA screen is
  93.   determined from the settings of the RetinaScreenmode program.
  94.  
  95.   If you want to use the RETINA-driver by default, you can do this by
  96.   setting the environment-variable GS_LIB to 'retinaXX'.
  97.  
  98.   After starting Ghostscript with the RETINA device, the page will be
  99.   rendered with the maximum screen size or with the specified
  100.   geometry.
  101.  
  102.   You will observe a remarkable slowdown if you render a picture with
  103.   8 bit CLUT compared to 24 bit. One reason is, that Ghostscript has
  104.   to maintain the CLUT and eventually do the dithering if it runs out
  105.   of colours. The other reason is a bug in the FillRect()-Function of
  106.   the retina.library which makes rectagle filling impossible in the 8
  107.   bit mode. Instead i had to use DrawLine() to fill rectangles.
  108.  
  109.   This bug is fixed in Version 3.8 of retina.library which is
  110.   contained in MacroSystem's update package V1.2. If you have this (or
  111.   a later) version of the library, Ghostscript will automatically
  112.   detect it and use its faster rendering routines.
  113.  
  114.  
  115. ILBM DOCUMENTATION
  116.  
  117.   The ILBM driver is a Ghostscript device for converting Postscript to
  118.   the commonly used IFF-ILBM files. This standard file format has been
  119.   defined by Electronics Arts and allows a variable number of
  120.   bitplanes and a simple form of image compression.
  121.  
  122.   There are currently two ILBM devices, which are writing output files
  123.   with a different number of bitplanes, namely the 'ilbm8' device
  124.   which uses a 256 color palette, and the true color 'ilbm24' device
  125.   which writes a 24 bit non-CLUT iff file.
  126.  
  127.   Each mode always uses runlength compression, which in most cases
  128.   makes output files shorter.
  129.  
  130.   There is still a bug in the output routines, which makes the request
  131.   ">>showpage, press <return> to continue<< appear after writing the
  132.   file. You can avoid this by piping NIL: into Ghostscript or setting
  133.   the flag -dNOPAUSE. It may also be possible that multi-page output
  134.   does not work in the current version of there ILBM-driver, i don't
  135.   know if it is allowed to put more than one picture in an ILBM file.
  136.  
  137.   I decided to use the Amiga iffparse.library for writing IFF-files,
  138.   so this implementation has two problems: you can't compile in on
  139.   other machines without a replacement for the iffparse.library.  This
  140.   is rather hard to fix, if you really want to compile on a non-Amiga
  141.   platform, you have to rewrite the code.
  142.  
  143.   The other problem can be fixed, it arises from the stream management
  144.   the library uses. It is easy to work with the AmigaDOS functions for
  145.   writing files, but GCC implements a slightly different filesystem
  146.   for compatibility with UN*X. It is possible to use the GCC buffered
  147.   I/O-functions together with the iffparse.library, but the price is
  148.   high: i would have to write assembler inline code, which is not very
  149.   portable nor easy to understand.
  150.  
  151.   So in contrast to other Ghostscript devices, the ILBM-driver uses
  152.   AmigaDOS pathname conventions: full pathnames contain colons, an a
  153.   an initial slash means parent directory, not root directory.
  154.  
  155.  
  156. BUG REPORTS
  157.  
  158.   Bug reports and improvements are welcome, send them to my address in
  159.   the header (EMail preferred).
  160.  
  161.  
  162. Have fun with Ghostscript,
  163.  
  164.   Andreas
  165.  
  166.      - --  O  
  167.     - --  /   
  168.   --  ***/\=+c
  169.   - - /\*\**/\
  170.       \/ /  \/<
  171.  
  172.  & Landi